home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / bbs / dalgames.zip / GFEST123.ZIP / SYSOP.DOC < prev    next >
Text File  |  1995-06-15  |  26KB  |  511 lines

  1.       GRUNT FEST Version 1.23 --  Program & Design by Robert A. Dalton
  2.                            Another great DDPlus game!
  3.                            Copyright (C) 1994 & 1995
  4.  
  5.         NOTE:  Items marked with a "*" have changed since the previous
  6.         edition.
  7.  
  8.                                   DISCLAIMER
  9.  
  10.         The author has taken every precaution to insure that no harm
  11.         or damage will occur on computer systems operating this package.
  12.         Nevertheless, the author shall NOT be held liable for whatever
  13.         may happen on your computer system or to any computer systems
  14.         which connects to your own as a result of operating this package.
  15.         The user assumes full responsibility for the correct operation of
  16.         this software package, whether harm or damage results from software
  17.         error, hardware malfunction, or operator error. NO warranties are
  18.         offered, expressly stated or implied, including without limitation
  19.         or restriction any warranties of operation for a particular purpose
  20.         and/or merchantability.  If you do not agree with this then do NOT
  21.         use this program.
  22.  
  23.                                 LICENSE AGREEMENT
  24.  
  25.         The game program, support files, and documentation are
  26.         copyrighted products of Bob Dalton.  Bob Dalton reserves all rights
  27.         to these products. This is protected by the United States of America
  28.         (USA) and International Copyright Laws. In no way shall the
  29.         components of the game software package be reproduced
  30.         or modified in any form or method without prior expressly written
  31.         permission from Bob Dalton.
  32.  
  33.         Tampering with or altering the contents or integrity of the game
  34.         software package is prohibited. No fee may be charged by any
  35.         agency other than Bob Dalton beyond the cost of distributing
  36.         unregistered copies without prior expressly written permission from
  37.         Bob Dalton.
  38.  
  39.         A major portion of this software was written by Scott Baker and
  40.         Steven Lorenz. Mr. Baker's Doordriver kit and the changes made
  41.         by Mr Lorenz have been used for the communications and interrupt
  42.         handling and this part of the software remains copyrighted by them.
  43.  
  44.         This game is distributed under the Shareware concept. You are
  45.         allowed to operate this game for a trial period of thirty (30)
  46.         days. After this trial period, you must register the game 
  47.         or discontinue its usage. Again if you do not agree with this
  48.         then do NOT use this game.
  49.  
  50.      
  51.                              INTRODUCTION:
  52.                              ------------
  53.  Grunt Fest (GFEST) is half wargame and half card game and can be
  54.  played in a single user log on session on most BBS's.  It takes place in
  55.  the near future between 1995 to 2005.  The goal is simple: Utilizing
  56.  cards drawn from a play deck attempt to destroy all the COMPUTER opponents
  57.  Mechanized Infantry Platoon while attempting to keep that fate from
  58.  happening to yours. Easy? Think again!
  59.  
  60.                              REQUIREMENTS:
  61.                              ------------
  62.  At this point in time the only requirements are FILES=10 (or more) in your
  63. *config.sys file and ANSI.SYS. DOS SHARE must also be loaded. The game is
  64.  RIP aware but NOT a RIP Game at this time. A FOSSIL is NOT required to run
  65.  the game, although one will be supported if it exists. Automatic time
  66.  slicing support is provided to most common multi-taskers as well.
  67.  
  68.                             Files Included
  69.                             --------------
  70.  Below is a listing of all files for the this Game.  If you are
  71.  missing ANY of these files (except for the DOC and FRM files), the game
  72.  will NOT function.  Feel free to give out copies of the ENTIRE archive
  73.  package of this game but please make sure all the files below are in that
  74.  package:
  75.  
  76.  ARMY.ANS     - ANSI Opening Screen for GRUNT FEST 
  77.  SAMPLE1.BAT  - A sample BAT file which runs the game program from the
  78.                   game directory.
  79.  SAMPLE2.BAT  - A sample BAT file which runs the game program from any 
  80.                   node directory.
  81.  SAMPLE3.BAT  - A sample BAT file identical to the one I use on my Single
  82.                   node WildCat Support BBS.
  83. *GFEST1.CTL   - Un-edited and heavily commented sample of a CTL 
  84.                   Control file for setting up GFEST and
  85.                   hereafter referred to in the game documentation as
  86.                   GAME.CTL.  If you decide to use it, be sure to
  87.                   rename it to GFEST.CTL first!
  88. *SAMPLE.CTL   - A copy of the GFEST.CTL file which I use on my BBS to
  89.                   run the game (WildCat 4.01S System, 386 33Mhz
  90.                   Computer, Single Node, 8Mb RAM, DesqView 2.63/
  91.                   QEMM 7.04, BNU Fossil locking port #1 at 19200 and
  92.                   using FrontDoor 2.02 and a US Robotics DS Modem,
  93.                   ANSI.sys loaded and SHARE loaded). I have left
  94.                   the comments in so you can understand what I
  95.                   am doing.
  96.  KEY.DAT      - Dummy Key for Grunt Fest (Good forever!)
  97. *FILE_ID.DIZ  - Ascii Description File for BBS Sysops on Grunt Fest
  98. *B4UASK.DOC   - Checklist for resolving setup/game play problems
  99. *HISTORY.DOC  - Grunt Fest Version History information file
  100. *SYSOP.DOC    - This text file you are reading
  101. *UPGRADE.DOC  - If you are upgrading - read this first!
  102. *DDSETUP.EXE  - GFEST CTL configuration program.  
  103. *GFEST.EXE    - Grunt Fest Main Program and hereafter referred to in the
  104.                  game documentaion as GAME.EXE.
  105. *REGISTER.FRM - Preprinted registration form and mailer
  106. *BUGRPT.FRM   - Preprinted bug report/suggestion/comment form and mailer
  107. *CATALOG.TXT  - A catalog with descriptions of all door games available
  108.                  from me.
  109. *DSITES.TXT   - List of sites where my games are distributed.  
  110. *HELP.TXT     - Support file required by DDSETUP.EXE
  111. *INSTRUCT.TXT - Game Player Instructions for Grunt Fest
  112.  GFEST.ZIP    - Compressed copy of the above instructions to make
  113.                  available on your BBS for download by players of the game.
  114.  
  115.  
  116.  Files created by the game when first played:
  117.  
  118.  GFSCORE.DAT  - Ascii Leaders Hall of Fame Scoreboard and hereafter
  119.                  referred to in the game documentaion as *SCORE.DAT.
  120.  SCORE.DAT    - Data file to store player scores between plays
  121.  
  122.  Files created by the game when errors are encountered:
  123.  
  124.  ERROR.LOG    - Log of system errors which happen during game play.
  125.  
  126.                            Installation
  127.                            ------------
  128.  
  129. --> NOTE:  The word "game" is used in place of the program name for
  130.            both the executable file (example GAME.EXE), and the CTL
  131.            file (Example GAME.CTL) in the documentation from this
  132.            point on. GAMEDIR is used in place of the program directory
  133.            in the documentation from this point on.
  134.  
  135.  1. Create a directory for the game (example: "WC30\DOORS\GAMEDIR")
  136.  
  137.  2. Make sure that ALL files listed above from the game package
  138.     are moved into that directory.
  139.  
  140.  3. Type "DDSETUP.EXE" and hit the enter key. The first thing it
  141.     will ask you is what the name of the CTL file is. Type in
  142.     "GFEST.CTL" and then proceed to the other settings. After 
  143.     you are done the GFEST.CTL file should be correctly configured.
  144.     Two versions of a fully commented CTL file are provided for
  145.     manual configuration.  One is identified by the game title
  146.     (example: GAME.CTL) and this is the UN-EDITED version and the
  147.     other is identified as SAMPLE.CTL is what a CTL file should look
  148.     like AFTER it is edited.  If all else fails - try the one I use
  149.     on MY support BBS (Sample.CTL). If you have fossil drivers be
  150.     sure to uncomment the 'fossil' option.  If you have a modem set
  151.     to a non-std IRQ be sure to use the PORT# option for that com
  152.     port. A CTL file generated by DDSETUP.EXE will have NO comments
  153.     and look quite different from my samples, but they WILL work
  154.     just as well, never fear.
  155.  
  156.     Where to put this file?
  157.     Put this file wherever you are running the game executable file from.
  158.     If you are running multi-node you could put a copy in each node
  159.     directory and run from there.  If you change directory to the GAME
  160.     directory put the file here.  See the example SAMPLE#.bat files.
  161.  
  162.  4. Edit the Key.DAT file.  Line #1 should be the sysops name, Line
  163.     #2 should be the name of the using BBS, do NOT change or edit
  164.     line #3.
  165.  
  166.  5. To insure proper multi-node use DOS SHARE must be loaded prior to
  167.      the game and prior to DESQview.
  168.  
  169.  6. In order to run the game program online the following parameters may
  170.      be used.
  171.  
  172.         "/Bxxxxx"   This tells GAME.EXE to lock its baud rate at
  173.         xxxxx.  In order to get the most efficiency out of a high speed
  174.         error correcting modem (9600 baud or above), you may lock the baud
  175.         rate to a speed higher than what the caller is actually using.
  176.         By locking the baud to say 38,400, the modem can compress text data
  177.         that is being sent and achieve a baud rate much higher than the
  178.         actual transmission rate.
  179.         This will lock the baud rate at the same value for all nodes that
  180.         use this command line.  If you perfer a more selective way to lock
  181.         baud use 'LOCKBAUD' command in the GAME.CTL file.
  182.  
  183.         "/Cx"     (where x is 1..4) This specifies a comport number.
  184.         Some bbs software does not create door information files (dropfiles)
  185.         that contain the comport number.  If your bbs does have a comport
  186.         listed in the dropfile then there is no need for this parameter.
  187.         The default is comport 0, local mode.
  188.  
  189.         "/E" - Expanded Memory Specification If your machine has over one
  190.         megabyte of memory, then you may have some available.  GAME.EXE can
  191.         utilize EMS to improve game performance and reduce conventional
  192.         memory requirements.
  193.         This command will tell GAME.EXE   to use EMS memory to hold its
  194.         overlay buffer.  Otherwise disc area may be used to hold this buffer.
  195.         This needs a memory manager and when enabled and is compatible with
  196.         DESQview.
  197.  
  198.         "/L"      This tells GAME.EXE to load up in LOCAL mode.
  199.         This is good for testing or when a sysop just wants to "try out" the
  200.         door without messing with his BBS setup.  The "/L" mode will ask the
  201.         user for his name and run the door in local mode.
  202.  
  203.         "/Nx"     (where x is 1..9) This specifies a "node number".
  204.         Some bbs software support multinode environments in which you must
  205.         know the node number of the drop file to use. For example, RBBS-PC
  206.         uses DORINFOx.DEF. If you specified "/N2" then GAME.EXE would use
  207.         DORINFO2.DEF.
  208.  
  209.         "/Mx"     (where x is up to 2 filename acceptable characters)
  210.         Used to specify one of Multiple control files.  If you have created
  211.         more than one GAME.CTL file (GAME1.CTL, GAME2.CTL, etc.) for each
  212.         node or network PC then you can select the one you want by using
  213.         the /M parm.
  214.         Example:  "/M2" will force GAME.EXE to use GAME2.ctl.
  215.  
  216.         "/Pyyy"   This specifies the path to the drop files.
  217.         For example, "/PC:\WILDCAT\WCWORK\NODE1" would tell GAME.EXE to
  218.         look for the drop file in C:\WILDCAT\WCWORK\NODE1. If this is left
  219.         out the program assumes the drop file is local.
  220.  
  221.         "/V"    This command will tell GAME.EXE not to show any display
  222.         on the local screen.  Only a colored screen and a message will be
  223.         displayed.  The cursor will not move as it will be turned off.
  224.         Saves a little processing on multi-tasking systems.
  225.  
  226.         "/W"      This flags the program that a network is present even
  227.         though no multitaskers are detected.  This is useful if the door is
  228.         run on a network such as Novell that doesn't use multitaskers.
  229.  
  230.             COMMON ERRORS
  231.             003  File path not found. Check to make sure the game
  232.                  directory is correctly named as GAMEDIR.
  233.             201  Files not found. Check to make sure that all required
  234.                  games files are in the GAMEDIR directory.
  235.  
  236.  7. Install the door into your BBS software (see your BBS
  237.     software documentation for more information).  A batch file is
  238.     normally used to do this.  To run the program just have your
  239.     batch file change to the GAMEDIR directory and run GAME.EXE -
  240.     Thats all there is to it!  Three different batch files sample
  241.     are included to help you run the game. These are included with
  242.     the game for editing and your use. Remember when writing the
  243.     batch routines for my games you must ensure that the game is
  244.     run from it's home directory AND that the game knows where to
  245.     find the drop file.  Satisfy these two requirements and you
  246.     should have no problems running the game as long as the other
  247.     setup criteria has been met. For dorinfo systems try using the
  248.     following: 
  249.  
  250.                             Sample Batch File
  251.                             -----------------
  252.            
  253.                  COPY DORINFOx.DEF \RBBS\DOORS\GAMEDIR\*.*
  254.                  CD \RBBS\DOORS\GAMEDIR
  255.                  GAME x <-=- NODE number !!DO NOT USE "x"!!
  256.                  del dorinfox.def            
  257.                  CD \WC30
  258.  
  259.             -->  Please note that you replace the "x" with the appropriate
  260.                  node number. Ex: Dorinfo1.def ; Dorinfo2.def ; etc...
  261.  
  262.  8.  If you would like a score bulletin just have the game batch file
  263.       copy the *SCORE.DAT file to wherever you have your bulletins.
  264.       Example:
  265.       Copy C:\WC30\DOORS\GAMEDIR\*SCORE.DAT C:\WC30\BULL\BULL11.BBS
  266.  
  267.      Please note that NO *SCORE.DAT or SCORE.DAT files will be generated
  268.      UNTIL a player completes a game and has better then a zero (0) score.
  269.      If the first player quits BEFORE finishing the game neither of the
  270.      files will be created.
  271.  
  272.  9.  Surprise!  There is NO daily maintenance to be performed.
  273.  
  274.  
  275.                   RESTRICTIONS ON THE UNREGISTERED GAME
  276.                   -------------------------------------
  277.  Until the game is registered the following restrictions are in effect:
  278.  
  279.  a.  Players can only have one game choice option at the beginning (usually
  280.      means they can choose only one side or one map depending on the game).
  281.  
  282.  b.  There will be a slight delay experienced by players at the beginning of
  283.      the game.
  284.  
  285.  c.  Registering the game disables the above.
  286.  
  287.  d.  Once you are registered any future updates can be obtained free
  288.      through my BBS and my upgrades are ALWAYS easy to implement!
  289.  
  290.  e.  I am always improving my games - so check my BBS for a more current
  291.      version.
  292.  
  293.                      WHAT TO DO IF THERE ARE PROBLEMS
  294.                      --------------------------------
  295.  
  296.  Every effort is made to ensure that the game runs correctly before it leaves
  297.  my BBS as Shareware.  If you are experiencing problems please do the
  298.  following BEFORE calling me:
  299.  
  300.  1.  Read ALL the SYSOP.DOC to ensure you have setup the program
  301.      and have met all the program requirements.
  302.  
  303.  2.  Use the B4UASK.DOC as a checklist to ensure that you have
  304.      not done anything wrong.
  305.  
  306.  
  307.                              Multinode use
  308.                              -------------
  309.  This game supports multinode use and provides automatic multi-tasker
  310.  support  (time slice releasing) for a wide variety of multi-taskers.
  311.  
  312.                Common Problems (Locked Bauds, High Speed modems, etc)
  313.                ------------------------------------------------------
  314.  
  315.         1.   The game does NOT require a fossil driver to run.
  316.  
  317.         2.   If you are running a high speed modem (9600 baud or above),
  318.              then I suggest you run your bbs/mailer/doors at a locked baud
  319.              rate. On high speed error correcting modems, locking the baud
  320.              rate will have a noticeable increase on the speed of text that
  321.              is sent. It's beyond the scope of this document to discuss
  322.              configuring your BBS and mailer for a locked baud rate; you may
  323.              wish to consult those docs for information on that. Here are a
  324.              few things to keep in mind when setting up GAME with a locked
  325.              baud rate:
  326.  
  327.              a.  When using a locked baud rate, I highly recommend
  328.                  using a  FOSSIL driver. This game will work at high
  329.                  speeds without one though. BNU is a good fossil driver
  330.                  which can even be loaded and unloaded before and after
  331.                  you run this game.
  332.  
  333.              b.  If you are using a fossil, then make sure to tell the
  334.                  fossil that the port is locked. For BNU, to lock com1:
  335.                  at 38,400, you would use something like "L0=38400" on
  336.                  BNU's command line.
  337.  
  338.              c.  If you lock the baud for one program, it must be
  339.                  locked for everything. You can't lock the baud for just
  340.                  this game, but not your BBS/mailer.
  341.  
  342.              d.  You may need to use the /B switch on the game.exe
  343.                  Command line to specify the locked baud rate. For
  344.                  19,200 this would be "/B19200" and for 38,400 this
  345.                  would be "/B38400". Please note there is no space
  346.                  between the "/B" and the baud rate.
  347.  
  348.         3.   What follows is some information on possible strange
  349.              situations that may occur:
  350.  
  351.              a.  Low speed users can play the game, but high speed
  352.                  users get garbage.
  353.      
  354.                  - If you are not using the DORINFOx.DEF or
  355.                    DOOR.SYS drop file then you may wish to find a
  356.                    converter program to convert whatever drop file
  357.                    your BBS produces to the DORINFOx.DEF or DOOR.SYS
  358.                    format and tell game.exe to use that.
  359.  
  360.                    Several converter programs are readily available
  361.                    on most BBS systems. CallDoor is a good one if you
  362.                    can find it. I have it on my BBS for download if
  363.                    you need it.
  364.  
  365.              b.  The game hangs up when a user enters the game.
  366.  
  367.                  - Sounds like the game is getting the wrong baud
  368.                    rate somehow. Try switching over to the DOOR.SYS
  369.                    drop file method if possible.
  370.  
  371.              c.  Text and screens are getting cut off.
  372.  
  373.                  - If you are running with a locked baud, then this
  374.                    could be caused by some sort of FLOW CONTROL
  375.                    problem. Try using a fossil if you aren't already.
  376.  
  377.              d.  If you're using something other than the DOOR.SYS
  378.                  drop file, then I always suggest trying to use
  379.                  DOOR.SYS if possible. It is the most reliable method
  380.                  and has had the most testing. If that is not possible
  381.                  try DORINFOx.DEF as an alternative.
  382.  
  383.              e.  A door locks up node 1.  This can happen with fossils
  384.                  or the internal communications routines because it
  385.                  uses the default comport of 1 when NONE is found in
  386.                  the dropfile or game.ctl file. To correct this make
  387.                  sure the right port is shown in the dropfile OR
  388.                  game.ctl file.
  389.  
  390.              f.  ANSI is reflected correctly on the local screen but
  391.                  the user is getting garbage.  Assuming the user has
  392.                  ANSI installed then most likely the problem is at
  393.                  your end. First make sure you have configured the 
  394.                  game.ctl file to show the correct locked port rate.
  395.                  Second make sure the dropfile is passing the locked
  396.                  port rate INSTEAD of the actual conncet rate.  If it
  397.                  is not passing the locked port rate then you may
  398.                  need to use a different dropfile format OR use a
  399.                  dropfile converter program to change the line to
  400.                  show the locked port rate INSTEAD of the actual
  401.                  connect rate.
  402.  
  403.  
  404.                        "Corrupted" data files
  405.                         ----------------------
  406.  It is possible that something could happen to your game data file.
  407.  A power outage, game crash, or other event could damage the data
  408.  files.  If you get  one of these messages, then the best thing to do is
  409.  eliminate the SCORE.DAT and *SCORE.DAT files and start the game again to
  410.  create a new one.
  411.  
  412.                     
  413.                               CREDITS:
  414.                               --------
  415.  This relatively small section is just to recognize the GOOD people
  416.  who have made this door a possibility.
  417.  
  418.  Scott Baker        -=*=- The author of the door driver package which
  419.                            made this game possible. Great job Scott!!
  420.  
  421.  Steven Lorenz      -=*=- The author of the enhanced add on package
  422.                            to Scott Bakers DoorDriver.  Thanks to his
  423.                            allowing me to use his modifications I
  424.                            was able to delete the fossil requirement
  425.                            and add many new communication and other 
  426.                            enhancements to my games. Thanks Steve!
  427.  
  428. DESQview is a registered trademark of Quarterdeck Office Systems.
  429. Doordriver kit is proprietary software by Scott Baker.
  430. Ripscript & Ripterm are registered trademarks of TeleGrafix Communications.
  431.  
  432.                                Where to reach me
  433.                                -----------------
  434.  
  435.         I can usually be reached at my BBS system, which should be
  436.         listed in the section entitled "registration" which is below.
  437.         I also habitually monitor ALL door related echos in the FIDO
  438.         Net System.
  439.  
  440.  
  441.                                   Registration
  442.                                   ------------
  443.         If you or your users enjoy this game, then please register it.
  444.         Information on price and how to register is shown on the
  445.         enclosed REGISTER.FRM.  Registration will disable the delay,
  446.         allow additional options and entitle you to life time support
  447.         through my BBS.  BBS Support includes unlimited free updates
  448.         and upgrades (not like some door game authors who charge for
  449.         major upgrades/updates!) through my BBS and access to the game
  450.         support conference on my BBS.  To register this game just print
  451.         out the registration form (REGISTER.FRM) file included with the
  452.         game and  send it with your check or money order to:
  453.                     
  454.                                Robert A. Dalton
  455.                                203 Old Farm Road
  456.                                Harrison, AR 72601
  457.  
  458.  
  459.                            HOW TO REACH ME BY MODEM
  460.                            ---------------------------
  461.  
  462.                              The TANSTAFL BBS (USA)
  463.                 (501) 741-5699  (USR Dual- 2400 to 14400 baud)
  464.                                Fidonet 1:391/3010
  465.  
  466.         Reminder: You will be mailed a LETTER with your registration
  467.         code.  Just allow an appropriate amount of time (a week or two)
  468.         after dropping your check in the mail for it to arrive to me
  469.         and the code to be sent by mail back to you.  If you need it
  470.         sooner log onto my BBS, leave me a message telling me you
  471.         mailed the registration and when I receive your check or money
  472.         order I will post a private message on the BBS giving you the
  473.         key code.  If you do it this way please allow at least a week
  474.         from the time you mail it to the time you call and get your
  475.         code. If you go the BBS route you will ALSO receive a key code
  476.         by mail. If you live in NORTH AMERICA I can also send your key
  477.         via Netmail for an additional $1.00, if you would like, through
  478.         the FIDO system (only). REMINDER: No disks are sent, if you need
  479.         the most current version you must call OR freq my BBS for it.
  480.  
  481.                         Bug Reports/Comments/Suggestions
  482.                         --------------------------------
  483.         I have made every attempt to make sure the game is free of bugs,
  484.         BUT the possibility always exists that one may have been missed
  485.         by me or the playtesters.  If you find a bug, or have a
  486.         suggestion or comment to make which would make future versions
  487.         better please print out the BUGRPT.FRM and mailer, fill it out,
  488.         and send it to me.  I read ALL of them and those people that
  489.         lead me to find a bug or generate a better game will receive
  490.         credit in the game documentation. PLEASE DO NOT NOTIFY ME OF
  491.         PROBLEMS AND EXPECT ME TO FIX THEM IF YOU HAVE FAILED TO
  492.         PROVIDE ME WITH THE BUGRPT.FRM AND OTHER INFORMATION I REQUIRE
  493.         AS STATED IN THE B4UASK.DOC.
  494.  
  495.  
  496.                                FIDO INFORMATION
  497.                                ----------------
  498.         My BBS supports file "freq"ing at 9600 baud or above. Just
  499.         call 1:391/3010.  I also carry a door library of over 450 of
  500.         the all time best door games which I try to keep current. 
  501.         For a list of these doors just freq "DOORS". I am always adding
  502.         new things to my games so most likely there will be a later
  503.         version of the program available on my BBS then the one you
  504.         have. For a current version of the game just freq the magic
  505.         name shown in the catalog document which is in the game package.
  506.         For a list of ALL my files just freq "TANSTAFL.ZIP".  If you
  507.         are a door game/program writer why not send me a copy of your
  508.         game/program?  If you have a more current version of a door
  509.         then I have, please consider sending me a copy as a token of
  510.         your appreciation for the service I offer at NO cost to you.
  511.         Thanks!